home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 651-660 / 654 / dsound / dsound.doc < prev    next >
Text File  |  1995-03-15  |  3KB  |  78 lines
  1.  
  2.                    DSound V1.00
  3.  
  4.      DSound is Copyright 1991-1992 by Dave Schreiber, All Rights Reserved.
  5. This program is freely distributable, but may not be sold (although a small
  6. fee for copying, media, etc. may be charged).
  7.  
  8.      DSound is a CLI-only utility I've written  to play 8SVX sound samples
  9. directly off a hard drive. While it only takes up a small amount of chip
  10. RAM, it can play samples of unlimited size off a hard drive. I've tested it
  11. on an Amiga 3000, a 2000 with an A2091 controller (BTW, I'd like to thank
  12. the people at HT Electronics, Sunnyvale, CA, for letting me test DSound on
  13. one of their 2000s), and an Amiga 1000 with a Microbotics hard drive
  14. controller (again, many thanks to its owner, Chad Netzer, both for the time
  15. he spent testing DSound and for the many useful suggestions and bug fixes).
  16.  
  17.     There have been a number of changes since the last version.  DSound now
  18. supports both mono and stereo samples, and can play a either one or both
  19. channels of a stereo sample out of one or both speakers.  A mono sample can
  20. also be played out of both speakers.  It is now possible to load the entire
  21. sample into memory, rather than reading it off of disk as it is played
  22. (this is included so that a sample can be played from floppy).  A couple of
  23. bugs have been fixed, and the part of DSound that reads the sample from
  24. disk has been made more robust.  Finally, DSound has been made pure, so
  25. that the program can be stored in memory by using the Resident command.
  26.  
  27. Usage:
  28.    dsound [-l][-r][-f][-2][-m][-s<speed>][-v<volume>][-b<bufsize>] soundfile
  29.  
  30. Where the flags are defined as such for a mono sample:
  31.  
  32.      -l - Play the sample using the left speaker
  33.      -r - Play the sample using the right speaker
  34.      -2 - Play the sample using both speakers
  35.  
  36. When playing a stereo sample, the above switches have the following
  37. meanings:
  38.  
  39.      -l - Play the sample's left stereo channel
  40.      -r - Play the sample's right stereo channel
  41.      -2 - If this switch is used in conjunction with the -l or -r switch,
  42.       the specified channel of the stereo sample will be played out of
  43.       both speakers.
  44.  
  45. The following switches have the same meaning for both stereo and mono
  46. samples:
  47.  
  48.      -f - Turn the low pass filter off when playing a sample
  49.      -m - Load the entire sample into memory before playing
  50.      -s<speed> - Play the sample at <speed> sampes per second (up to 28000)
  51.      -s<volume> - Play the sample at a volume of <volume> (1 to 64)
  52.      -b<bufsize> -- Use buffers of size <bufsize> (default is 30K).  If
  53.             you're experiencing breaks in the sound, try increasing
  54.             this value.
  55.  
  56. If you don't specify any flags, the defaults are (with a mono sample) to
  57. play the sound out of the first available speaker, with the filter on, at
  58. the speed and volume specified in the soundfile.  With a stereo sample, the
  59. defaults are the same, except each stereo channel is played out of the
  60. appropriate speaker.
  61.  
  62.      DSound will open a window when it starts playing the sample, and will
  63. keep the window open for as long as the sample plays. If you want to stop
  64. DSound in the middle of a sample, click on the window's close gadget.
  65.  
  66. I've included the source for DSound.  To compile (using SAS/C V5.10a) type:
  67.    lmk
  68.  
  69. If you have any questions, comments, etc. regarding DSound, don't hesitate
  70. to get in touch with me at:
  71.  
  72.                          Dave Schreiber
  73.                          1234 Collins Lane
  74.                          San Jose, CA   95129-4208
  75. e-mail:                      davids@cats.ucsc.edu
  76.  
  77.  
  78.